home *** CD-ROM | disk | FTP | other *** search
/ FishMarket 1.0 / FishMarket v1.0.iso / fishies / 401-425 / disk_417 / mostcurrent / read_me! < prev    next >
Text File  |  1992-05-06  |  5KB  |  123 lines
  1. Most Current
  2.  
  3. This program will update B. Lennart Olsson's Aquarium (V1.12) database
  4. so that a new button will be created called "Most Current".  Each entry
  5. in the db that is the most recent available will have the "Most Current"
  6. button set, and all of it's precursors will have the button cleared.
  7. This way people will no longer have to search backwards through the db
  8. to find the most current version or read multiple entries for the same
  9. program.
  10.  
  11. As of disk 360 there are 1836 entries in the Fish Library.  However,
  12. 402 of them are versions that are no longer current.  Those buttons
  13. will have the "Most Current" button cleared.
  14.  
  15.     There is a cost for this feature, you must give up
  16.         one of the following buttons:
  17.  
  18.             Assembly
  19.             Basic (or)
  20.             Modula II
  21.  
  22. This will make room for the new button "Most Current".  The button
  23. that you give up will be thrown into the category "Other code".
  24.  
  25. You're better equipped to use these programs if you read the whole
  26. doc, but if you just can't stand reading documentation, and you
  27. >>have to<< implement the program --->NOW<---, do the following:
  28.  
  29.     1) Get on to the CLI or Shell (sorry Mouse users).
  30.     2) CD into the directory where you keep your Aquarium.
  31.     3) Execute the script "Ren" found with this package.
  32.         This will do the following renames:
  33.             o "KeyNames" to "KeyNames.old"
  34.             o "index" to "index.old"
  35.     4) Run the program "ClearSpace" and tell it which
  36.        button you want to give up.
  37.     5) Run the program "MostCurrent".
  38.     6) Look at all the little fishies in your aquarium.
  39.        If you don't like what you see:
  40.            Delete the files "KeyNames" and "index", and then
  41.         rename "KeyNames.old" to "KeyNames", and
  42.         "index.old" to "index", and everything will be
  43.         back to normal.
  44.        If you like what you see:
  45.            Delete the files:
  46.            "KeyNames.old" "index.old" and "index.tmp"
  47.            Read the Miscellaneous Notes at the bottom of this.
  48.  
  49.         ...and in the future...
  50.         When you add new fish to your library you can run
  51.         the program "MostCurrent" again by doing the following:
  52.         1) Drop your new fish in the aquarium (using NewFish).
  53.         2) Rename the file "index" to "index.tmp".
  54.         3) DO NOT run the program "ClearSpace" again!
  55.         4) Run the program "Most Current" again.
  56.         5) Confirm that your aquarium works to your liking.
  57.         6) Delete the file "index.tmp"
  58.  
  59. Detailed explanation
  60.  
  61. This software "package" comes as two (count 'em) standalone programs.
  62. The first (ClearSpace) should be run only once.  This program will ask
  63. you which button you wish to surrender.  It will first adjust all the keys
  64. in the "index.old" file to create the empty space for the "Most Current"
  65. button.  The output will be placed in the file "index.tmp".  It will then
  66. read the "KeyNames.old" file and change the headers so that the buttons
  67. read correctly when you plug in the lights on your aquarium.  The output
  68. will be placed in "KeyNames".  This program will abort before doing any
  69. modifications if the "KeyNames.old" file has previously been changed by
  70. the ClearSpace program.
  71.  
  72. The second program (MostCurrent) will read "index.tmp" and update the
  73. "Most Current" button.  It may be run again in the future when you add
  74. new fish to your aquarium.  After adding the new fish, just rename the
  75. "index" to "index.tmp" and run the "Most Current" program again.  If
  76. any of the new fish are updates to fish already in the aquarium,
  77. "MostCurrent" will recognize them, and update the "Most Current"
  78. button appropriately.
  79.  
  80. F    L   A   W   S
  81.  
  82. The MostCurrent program recognizes entries by the entry in the Name
  83. file (not case sensitive).  Some updated programs have new names on
  84. them (like Yachtz3, etc.).  I did not put any logic into the program
  85. to recognize these name changes.  Therefore both versions will be
  86. considered "Most Current".  A few programs have duplicate names,
  87. but are by different authors.  Rubik on Disk's 285 & 362 is
  88. one example.  The former will have it's "Most Current" button
  89. cleared (sorry Roger).
  90.  
  91. The programs will operate on up to 10000 entries as written.  If
  92. you're still alive after disk 1960 comes out, then just modify
  93. the defintion SIZE in "MostCurrent", and recompile (see below).
  94.  
  95. Miscellaneous Notes
  96.  
  97.   o The programs will preserve any comments you have
  98.     made in the "KeyNames" file.
  99.  
  100.   o Thanks to Howard Hull for the technical docs,
  101.     without which I wouldn't have bothered to write this.
  102.  
  103.   o Someone who's smarter than me might want to write
  104.     a quick patch program so that the Aquarium comes
  105.     up with "Most Current" on.
  106.  
  107.   o I included the source because I'm a nice guy.
  108.     It was compiled with Manx 3.6a as follows:
  109.         cc ClearSpace +p
  110.         ln ClearSpace -lml32 -lcl32
  111.         cc MostCurrent +p
  112.         ln MostCurrent -lml32 -lcl32
  113.  
  114.   o If you like this program, please send twenty-five
  115.     cents (U.S. only, sorry no checks accepted) to:
  116.  
  117.             Peter A. Phelps
  118.             3515 Central Road, #304
  119.             Glenview, IL  60025
  120.  
  121.         and I will think of you often.
  122.     (Watch... I'll probably get bombarded with quarters!)
  123.